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ABSTRACT 

This report d^cuDnents the BASIC In struct io^al Program 
IBlp)^ a "haiias-on a^bcratory»» that tiachee eleVentary prograoaiiig in 
th^ Basic languager as implefflented in ttte MAIKSAIL languagG^ a 
fflachine-inaep^ndent ire^ision of SMI which should facilitate 
ioipleme station of BIP on othfr coiputliig syatem^i, light InatriictiDnai 
ffoaal^g which tfate.up the Blp^iysteo ^le aeacribed in detail^ 
inciuai^g cujrctculuiQ data atruetures and the infprfflatlon saved in 
student hiatoriea* yh€aa aodules are called" (1) ONOFP^ <2) Bi&, 0) 
PARSE, M«) XERS, (5) lERDOK^ (6) TEACHE^ I?) VEEFY, and (8) iSSfiECS? k 
list of techJiiaiies and skills withir the techniques la appended^ 
(AqthOt/CMV) ^ , 
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, FOREWORD 

fhi0 reaearch and developnient condiicted In, response. to Navy 

Deti^lon Coordinating Paper , Education and Training DeveLopment (NDCP- 
ZOlOB-^PN) undar subprojoct 20108-?Ni32, Advanced Coinputer-Ba^ed Sjsteme 
tot Jnatructlonal Dialogues , .and the sponsorship of the Director, Nav^l 
Educatlt^n and Training <0P^99) • The ovafall objectlve'of the pubproJeGt 
Ib to deveLop and evaluate advanced techniques of Individualized Ingtruction . 

This is one in a series of siK reports dealing ^itli the BASIC 
(Beginner -sAll^Purpdse Symbolic Instructlori Coda) Instructional Pro- 
grain (BlP)* which Is a "tutorial'* programming laboMtoiy designed for th^ 
studgric ^ho has had no previous training In prograttiming* ' 

Ptevlpus reports in the ptpgrani are concerned vith conversion of BIP 
into the MAIMSML prograrnmlng/language (Note 1, 1978), the DIP supervlsoty^ 
level manual (r^ote 2, 1978), MP 'student manuala (JJotfis 3 and 4, 1978)^ and 
curricultiin It^ffarmatlon networks for computer-assisted Instruction (Beard* 
Barr, Goiild/:^6 l^ascourt, This report la' intanded for use by Individual 

Involvej with the system-level support .of the BIp aygteni/ 

'The ,%^oth was performed undet^ Coritract NOOlZS-Te-^C-lS^a to Stanford 
Unlvt^st'ty, The contract monitors ^ere Dr, John D* pleteher and 
Dr* Wmes Hollan- t 
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The BASIC Inatructloiial Prograin (BIP) is a "hands-on lahoYatory" that 
ches elementary programmirig In the MStC language. ThlB report clocu- 
^ts the BIP system as implement<ert in MAINSAIL, MAINSAIL Is a fnachlne- 
dependant revision of SAIL which should faGllltate Implerneatatlon of 
P'on other computing systems. Each of the modules which raiake up tl/e 
Btmn Is described In detail. ' " t ^ 
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■ • .*,.SRCTrON L. IMTROnUCTION 1 

The BASIC Inatructlonal Program (BIP) is an lritfiraatiira_45toblem-solvlng 
laboratory thac teaches elementary programming in the BASIC language It 
waa^developed on the IMSSS PDP-10 rasearch computer facility: In a-.Bpeci4ll2ed 
high-level language called SAIL (Reiser, 1976),, which is presently avail- \ 
,able only on POP-IO computers. During the, year starting in October 1976 
M^Ti^fJ^r^^^-^" (Dflgeforde, Note 1) in the proiramming languAse called' ' 
MAINSAIL (MAchlne-INdependent SAIL) (Wilcox. 1977a) being developed at 
Che Stanford University Medical EKperimental (SUMEX) Computer Facility 
MAINSAIL, as reflected In its name, provides capabilities similar to those 
In SAIL independetitly of the underlying computer' syatem (Wilcox, 197713) 
It is, designed to be powerful and efficient, with a high degree of por-' 
cabllity on a, broad class of computers. Thus^ BIP was rewritten in MAINSAIL 
so th&t Impleiii^ncation on other (notably smaller) systems would be possible. 

BIP was written In elg»ht aeparately-oompllad models (ONOFF BIP PARSE 
XERS, mRDOK, TIACHR, VERFY, and MSRECS) that are brought into 'memory (by ' ' 
the MAINSAIL runtime system) during execution as needed. The foliowing 
'Sections describe the workings of all' those moaules as well as the cur- 
riculum data structures and the Inforinatlon saved 4n student histories.* 

I • ■ ' . • 
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SECTION 2. ONOFF MODULE ^ 

le ONOFF nodule perforins .ChreeVmaj or tasks at stud(5nt slgri-bn or 
f i , ' V 



Checks chat the student Is enrolled in the course. 

Sets up the currlculuin data structure* 

Reeds from and writes to the sti^ent's hlatory file. 



2.1 



a stud 
WHO ; f 1 
or If t 
tells t 
off. 



cklnq that Student Is Enrolled In Course 



ii tBKt £ lie. WHO contains each BIp ^studfent ' s number and name, When 
t slgna otl^by typing his number and first name^ BlP gaarches. the 
for^a lln^ with that Information. If no such number is founcip 
nama typed ^doea not match, the name #in the appropriate llne^ BIP 
student that thp number and /or name are Incorrect ^ and logs him 



2 # 2 Set^ in ^ Up the Curriculum Data Structu re 

Thel'|currlculurnA;^qr BIP. Is contained in a text file called TASKS. Be- 
fore any. fetudanCs. run BIP, the TODATA program is run to compraas certain 
/ea sent la 111 information from TASKS and ^rite it onto a data file called INIT. 
When a stddfent signs on, the INIT data is used to Initialise the curriculum 
data strudture. Throughout .a student 's-^ session, BIP reads from the TASKS 
file to acbesa the text of the current task, its hints and model^ etc. 
The poirtteta tiiat were initialized from the INIT data give BIP efficient 
access to^ ihe %mKt in the TASKS file. '\There are two data ptructurea that 
need tfo be jinitlaligedi one for the techniques, and ona for the tasks, 

' The pd 
grammlng te 
for a descr 
the start of 
.technique, 
within those 
each te^chnli 
shown in- 
the second , 



ntar array teehnlque has an element for each of the 16 pro- 
hniques in the curriculum (see Barrj Beard, & Atklnaon^ (1976), 
^pti0n of the curricnlum structure). Each element points to ' 
a Xiiiked 'list of -the numbers of the skills found In that 
Se^ the appendix for a list of the techniques and the skills 
techniques.) This InformatiQn about the sets of skills In 
e ta used by ^the task^selectlon aliorlthm (see Section 7). ^ 
sure 1, the first technique Includes skills X, 2, 5, and 8- 
ills 3, 4, 6, 7, 9, 10, 11, and 12,.etcn 




.8 



3 



r 

i 
j 



I 1 

I I ^ 
.i J 



I — ► I 8 I NULLPOINTER | 
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technique 
array 



Linked lists of skills in each technique 



16 [ ' j-^-^ [72 I NULLPOINTER I " \ 

Figure 1, Data structures for lists of skills irl techniques* 
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tUc data structure for th^ taskp is a linked list of records, one ' 
for each task. Each tecouKl . X3 fieldsi ' . 

1. "link,"' a pointer to the next main task .in rte linked list. . ' 

2. "name,"' the nAma oi tha cask. ,, . ' 

3. "tasklndeK," th^ taak numbar, . ■ 

4. "taskPos," the acatt pQaitlon (in the TAB«S ma) of the task 
description. „ 

5. "modelPos," the itaKt position (in the TASKS file) of the model 
solution. . 

6. "flrstHintPos,'"' ftha sta-ft poffition (In t.hc TASKS file) of the first 
hint. If there are 'not any 'hititi, it is set to zero, 

7. "nextHintPos,^' IjlitlaUy, the start position (in the TASKS file) "N, 
of the first hint (if any;). If there are tio hints, it 1« set to zero. 
During a BIP session, d£tm the sfcudent has seen a hint, nextHlntPoe is 

set to- the start position of Uhife next hint, if it exista, and to zero 
othecwise. 

"moreTask," ft pointer ta the start of a linkea ll«f of the "moreTasks," 
or extensions, of this task (if none exist. It is set to OTJLLPO INTER) . Each 
moreTask record inexactly liT^e a main task-^cord, except that the "link" 
field is .not used, and the "wwelaak" field points to the next record In the 
linked list of moreTasks til* Current main task, 

9. "reqOps," which km bit turned on for each BABia operato-r re- 
quired in the student's soluftion to this task (see bej ' 



10. "disOps," which km. A ^^ic turned on for each BASIC operator 
that the student may not use in Che solution to^thia tMk (see below). 

11. "reqFns,". which hm « hit turned on for each . Ewnctlon (INT, RND, 
and/or SQR) required in the itudent'a solution to this tmk (see below). ' 

12. "disFns," which h«» a bit turned on for each function that the 
student may not use in tbia saolutlon to t,his task (see below). 

13. "skills,"' a poincM CO a linked list of the programming skills 
used in the solution to thi's ^Mki, ■ ' 

Each. "reqOps" and "d'laOps"' field consists of 16 bits, one for each 
BASIC opierator that can be requited or disabled in a student's program- 

15 14 13 12 11 10 9 8 7 6 5 ■ 4 3 2 1 0 

) ip:: . for gosub read reopen ' ensub 

LET ■ GOTO REM SlO^ NEXT RETURN PATA ' BEGINSUB 
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T4ius^ l£ GOTO, and STOP were rGqulred in t\\d solution to a particular 

task, the ^r^qOps bits for that task would be 1010001000000000, where a y\ 
1 indicat'6^ that the bit is turned on and a 0 that It la turned off* 's^'' 

Each *'i^eqEns" and •'disPna" field uses 3 bits, one for each function : 
that could required or disabled in a student's programi 



INT 



1 

RND 



0 

sqr' 



Thus, If IMt were disabled in the solutldn to a particular task, the dlsFns 
bits for tMt task would be 100. ' 

2*3 Reaiil-rxEL .FrQin and Writin g to the Hlgwtyn^lle 

Each Ittdlv^idual student has a personal history file, a data file used 
to store iia^Orniation about the student^ a current state (what task he la 
currently WiO^rking on, hov many tasks completed so far, itc,)j and past per- 
formance on 'Casks and skills. ^ sign-on, thi$ file's Information is read 
in£o vajflabl^dq and arrays whose Elements are modified during the BIP session 
At sign-off and at numerous otlier points during the eession, the updated 
InformatlQn Jla written back out to the history file* 

The hi^ttory files contain the following inf ormatloni 

1, ThCjHlstory Sumniary 




vas^iables 

Bifcu4©ntNum 

Ift^t^Date'S ignorf 

last^JlmeSlgnon 

CQttteiaOn 

tQfctVuTOSessions 

numtteiksDone 

lasfeTnqUsed 

nan^tTiqToStaylTi 



c KM n Index 



bits 
ver l^ble 

^viK ^ W ^ Hi, ^ 

tn^Voird 



information 

atudent number 

date of last seaalon \ 

time of last session 

total time on (inlnutes) 

total number of sessions . 

total number of tasks completed 

hlgjiest technique used in last task ^selection 

0 - if no teGhnlque to "stay** in 

n ^ If task-selection algorithm should stay at 

technique n, since student had trouble with 

last task at that level 
Index into chron array (see below) 
nuinber of last main task seen 
nJmber of last task seen (either the same as 
tnainNum or-the numher of a moreTask of the last 
main task seen) 

Information , - 

L6 bits, one for each technique (bit 0 for 
tnq 1, J. for tnq 2, ^ > 15 for tnq 16), A 
bit la off If corresponding techniqua has never 
been "seen, on if it has. ^ 



6^ 



r 



. ' 2,. 
(BITS Is 

Is.t 

BITS 
l_ 

0 
1 

2 

3 .... 

4-a 

9 

10 

li 

12 

13-15 

2nd /, . 
BITS 



'fh»r.Ti^!8k Uiatorv— BITS array taking. Two bits-elements par task., .' 
a Mj'HlNS AIL data type for reprBaentlng a short s'efjuence of .bits.) 



CMi tents 



nw^i^ ,see task again 
mm passed^^verif ier 
X^mm^t on first try? 

said he underetood ^ta 
of €ailuree in verifier 
ab^K^is to leave after failu 
4iM|reed^ with verifier? 
mm the model 
Bm all the hints 
riuwb^r of hint requests 



sk 



re'; 



changed In routinG 

upVer,. enufo, varOption 
upVer ' (called by moreo) i 
'upVer J , 
postTaskfnt % 
moreo ' ^ ^ 

ver Option (called by verfy) 
ver Option , - 

modelo - . ' ^ ' 

hinto ; V 
hintor : ^ 
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0^2 
8=15 



skill 



task was eeen 
RiiMtas on task. r 



^finTaak (called^^by moreo , epu 
addTtoe (teacho, inoreOj enufdj 



3* '^^.^^^^S^.^^^^r^^^ ski Inf . /^Three bits^elenients pei 



1st. 
BITS 

6^10 
,11^15 



*^*f,.i*, ^ ^ as. 



tiii^iia .seen - 

tlttvea Caik passed ver if lar;-' 
ti^n^a ■ptfssed ^verlfier in a ro\g^. 



changed in routine 

f inTask ^ . ^ - \ 
^upVer (called: by moreo) 
.iJpVer h dowtiVer 



0-5 

6-10 

11=15 

3rd 
BITS 



BkthX ^'ok" in. post=task Int, 
skill '*ok" in a row 



postTasklnt 
postTaaklnt 



8-15 \/ , mim%m on skill 



add Time 



4* The Ghgotiolgg^gai Qr4e£:^Qg_j3-s^g"^^ITS array GhgQg_* Two hit^- 
''.eleanants pjr task, It^ ttie ord^i" ^he BCudent coTnpJeted the tasks* 



Is c 






BITS 




chaxiged in ^coutine 


n — 


^^^^^^ 

oti ifi t^si^ w^s specif ica 11 


--^-^ . — ; 




Te^ue st^d toy ^tudenC 




'1 ' . ' 


ever paas^d verifier 


^ upVer 


9 


pa ss^d eaii i£'st try ^ 


upV^r 


3 


on If ISnd er^tood'' ta^k 


postTaskJnt 


4-8 


nu:mt>fir failaxes in ve^ff ier 


morep 


9 


choae tc 1 oave aft^r failure 


Opt ion 


10 


disagreed' ^Ich verifier 


verOptior^ 


11 


sa3 che mp del. 




12 


sa^ ^11 th e t*ilnCB 


hlnto 


13^15 


nunibto of. hirst ^eqt^escg 


hlnto 


2nd 






BITS 






0-7 


task Id ant If i^catiptv nu^mbar 




8-^1 • 


ralnutes on Eask 





5. . Tile pa and _ T Ijne Eac J ^ ^ . ff ^ t^d^— ^ 1 ti g e r a£'ra3^ c ti^utjjjff. 'rij£e_ ' 

The are two alementa per task^ th^ first ceiling l^© da te ^ and tine second, 
the tlm€ of the start of the taslc, Fef ereMed by Chg corresponding elements 
of che chron arr^y* 

6* Ttie Sjudent^asg i§r^^d_ i'j-l e ^arQfea--Bcririg array at ui-_j.le . Ttie AbCll 
character codes^ of th^ chac^fictGrs 1^ ttie stiad@rit--asaigiied fille natneB are 
saved at tbe end o£ tfc^e stixden t KlaCor^^, ^ich the different natiiea separated, 
by 32j the character code for ^ spa^e. 
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sec HON 3; aip ^lODULE 



Ttie |IP module contains th^jjaatriBlP program pr QCg du ire , mm cl In » %^?hich 
scans aacft line typed by the stiidpnt to d^cWe ^ha^h^r it Is a' BIP command , 
a BASIC scatemant, a request fo^ ..^laelp, ot an er rot^. Ejceclin then calls 
an appropriate procedure to aitlier fQlL^cw th^ c omrnanciT'TTTfirse tha, state- 
mentj or tD'prlrit a help or errQt rne^Baae^ 

The 51? file's other ma in EDroiCedur^s hacidL^ ^tudeti t files, execute 
prograrns, prtnc help messages vtieti t^qu wasted by tMe ptu^lan-t, and save pro- 
tocols of the BIP sasslon (when de sit'ed by the supGr^^ls^or > . 

3; 1 EKeclln 'PrDcgdure 

When a ptudent .signs on^ the 3ip pc^og rani p^^f ornna mom^ tnltlali^a^ 
€ton and prepara4lon for the Be^st^on, ■ "IheTp it a^epeaceci :ly calls the main 
pracedure esjecllri to handle each tmpuK: ilnej ca3.11ng apgroprlate procedures 
depending on whether the line la a Ba^SIC's tatement , BC[p cominand , an 
error j or a request for help. ^ 

If Cbe first character: of the Itne is a "? ^" th^ prccedure 
(dascrtbad b^low) is called. 

If Che first character Is a n^niber^ gS^Ug e^p^cts c he line to be a 
BASIC statemeiit. It scans over th^ 1 ine^ n^nibGr an i^xpact 5 the nesct se- 
quence o£ nonblanlc charac tars be a BA^BIC o^e^^por (LET, WPUT, PRmT,. 
etc.). If it is^ a B4SIC operator^ then th^ pro&atlaar^ agn^^ Is called to 
parse the scatMent. If it Is aot 0 eaigUn chec^^s to see if the line is 
a user- function definition or a irP stat einmt^_ia^th%t ejcpliclc use of the 
word ''LKT," and if so , calls ^ynt^. Oc-hit.wt ee^ t%e llr^e tias an error- 
-eicher ,lt is missing a valid BASic" at^t&iilqt:^ or 1^: contains a BTP cOnBnaud 
following a lln^ niirnber. \ 

If the Input line does noc at£|rt with a/mirt^^beff^ ^ex^-clin expecta It to 
be a BIP command,. If it Is, thd^ apprQpr h.rCff pracec-iurte t o. carry out that 
command is called. Otherwlfie, the lit:\e mrv^ri ^Air^v^r it is m 

Illegal comniand .it has a BASIC: t?pe.:cnt which iu:iBs ing a line nurnber. 

rf= any of the above-ment Ipn^Kl poasiT3l£^ earrols nceurs, ejceel In chills 
the procedure. mg^T^t to get tht3 ^pp^ropri^t^ earo 't tciesartse, prints theit 
massage^ tells the studerib that the imput tinc^ ur^a no^^a cc^pted ^ and in^ 
ditcates th^t he may type fpr hglp^ ' 

3 . 2 Dealing vlch Student Fll m 



Students are sUowad to siivm to 30 of th^Ut^ p^aga-ain-a for later use. 
Ac any point, they can save the Qurl^nit prpgrai wndor a mvAG that they 
assign. Later they can retrieve ch«it prPgr« wtch thes -GRr - c onimand , or 
deletQ it with Che -KILL- coimnrfnd, Ac:~ any joints the -PriLES- command will 
list the namee of the files curre,rit3y et^r^^l, 

The name studonts Chink tlioi;r pr© gr#in la sa^^ed urydet- ai^d the name 
it Is ^^ctually storGd under are t(^o di ffcaracit thAngs* Ic necassary to 



assign the programs unique nflines- flo chnt. they *ire not ranfuHod wit h oiJ\<yr 
prograPis aav^d under the same namt's by Dth^r stUtiGntB. Mho ^ In order 
for a file n^me co be truely rnach InG-lndepfendenL: » It should consis: of 
no inoro than ^i:^ characters. Therefore, the format of the name under 
which the program is actually stored Is 

student nuniber>F<flle number- 

wherE* "file numher ' Is a; nurnbfer between 0 and 

D^irlng a BIP ses^lon^ the studenL filfe iituntta are in Lht^ sti iug artciy 
sjLiF^lj. It c.h© student "s nmilmt w^re^ say^ 88, then s tuFll^ [ 0] would 
the sttident-ass Igned nain© for the file S88P0, stuF 11 e [ 1] would be the narne 
for SSfiFls etc. Between sessloris, the scudant file names arc stored at the 
end of th^ sCudent history, ^ ^ 

Wrien a student aslcs to save a program ^ c h&i pt=<jc t^duE-^ Sjeiv eu retire !jes 
the StuF lie array for the ne^t null element, assigns It the name the student 
gave his program, creates a nev file whose naine is in the forniat described 
aboN^e, and copies the student prograni to that file, 

To rat r lev e a file, ^e^o searches sUxf il^e tor cha appiupriata student 
file n^ine (and tells the student If that name does not ax.iat), opens the ^ 
oorrespondlng file, and copies the saved program into tha student 'a working 

To deleCe a file, ^_il lo searches gtuFlle for the appropriate Btudent 
file n£3ine, dc^l^jCes the corresponding file^ and then sets &|iat elenierit of 
_s^t^il^ to nulU BO that it can be subsequently used v^hen tslie student 
Wants CD sav^ another prugram* 

Tu list the aavtjd ^LuderiL t ildri^ f^ ^l^^g o simply steps tlauu^h lUa 
atui'lll^ array cind type^j out thcs nonnuil el.emt;nts. 

Ihu procedure rui i o Ih colled to fc/^ut.MLt:; ^ pA^^^tani, i- i ^ t il caliL* 
doctor (the rna in p^^oceduro in che ERIiDQK module--sae Seciion 6) to chack 
the program fot structural errors. If none eKlstj it cDTnmencea InLerpre 
tcitton of the? program^ For each staterrients runo Bends xc,u te, tlie nialn 
XERS prooedure I the I^SIC operator used In the Htatenient ^ and then .Kcuie 
calls che appropriate procedure to Interpret It, Runo keeps tracH of the 
numhor of Btateiriffnts that have been e^cecuted and warns the student w]mn it 
is CiXC(3HaiVe, alnee ■ tho program may be In an Infinite loop. At th^it point, 
tha atiident haa the eptlDu of either stopplnH tsxecut Ion or cuntlnuing and 
tolling riino the niaKimutn nuinher of further stcitemantB to oxecute, 

3, A Tly^ H^j^ S^Btemja^ MSGS tdle 

OAt any poltit, tho student nuiy type a for help. The procedure 

J^lj5^ifj called to decide vhat typo of help t\\b ntudent needs. If the 
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is typed immediately following a syntax, scructural, or e*xeciitlon arror^ 
Help will give the studetit further Information about the type of error 
rnade and tell him to^ type for ttiore help kas ' long as it' is available--' 

there are up to four dlf f erant he Ip me_ssages Available for each error). 
If the student types "?RjEF,'' help refers htm tb a section of the- Student 
Matiual, ' * . ' \ 

If the'student types at any other time Vi,©., not after making an 

error), help will -simply state that BI? Is expactYng either a BIP cominand 
or a BASIC stanenient and that, he can type "?BASIC*^ to see a list- of the 
statementa and commands, ' ' 

\ 

Bo^ does hel£ know which help measage to give any point after an 
error has bean made? First of all, it Icnows which ty^e of error was made, 
since exactly ana of the \fariables aynjrf, dokflg, or yerflg ^for a syntax, 
structural, or eKe^ution error , -respeccively) will be npngerD and^ wil 1 
tell thk er^or number^ Helj keeps track of how many have been typed 

directly af ier, an error so that it knows which message (in the sequence of 
different help messages for the error) to print out. 

The help, tnessages are all in the file MSGS, along with the arror 
messages, the manual raference messages, and the skill descritt ions . Each 
group of messages is on a aeparate page of MSGS, in order. ri\e beginning 
of each page has pointers to the start of all the liessages on fc^hat page/ 
Given a page number and -a tneasage number^ the procerfure msgTxt will re- 
trieve the appropriate me<ssage from the file MSGS. Help knov^s the page 
numter for each type (syntactic, structural, or execution) of error made, 
and the error nuinbar from gynerf , dokflg^ or xerflg. So It simply computes 
which raeasage number should be presented Chased on the number of times 
Che student hm typed and calls gisglKt witlj^at number and the appro^ 

priate page number to gat that .message. 

3 , 5 Pro to col Saving 

The Supervisor at each blp iJupLembMLc li u^. i .Ju.lce ^.u^iu^, 
ot not tu compile tHe code ror protodal saving. This is done by setting 
the macro "canSaveProtocol'' (in the file ^lACROS) to TRUE or FALSK just 
before compiling the BIP modules. If it is TRUE, then the Supervisor 
my save '-protocols, ' or records of all that happens durinj^ student 
SGSsionsp for some or all BIP studerrts, ^^flnether or not they will in ^ci 
bo 0aved for individual students is detertnined during the creation of 
student historleB, by an optjlpn In the ne-wHst program. 

The protocol^saving code Is scattered throughout i\it, bLV modules. 
The BIP file containa two procedu res t hat are" often called by that code 
to ufrlte various Infortiiation to the protocol file. One, wrl teTaakB ,| wri 
the nanie and number of the task the student is currently working on\ The 
cither, wrltePro^ , writes the current student program, 

Che prdtocal^saving code was coinplled and the Supervisor said he 
wanted protocola saved for a Bpeclflc student, then a pirotocol of each 
of thaj student's BIP saaaions will be saved on his perBonal prDtocol 
file,. whosG name is of the format DAT<studant numbar>. 



11 



SRCTION 4. PARSE MOWLE' 



The purpose of the procedures In the PARSE rooduae i&Ho examine each 
of BASTC code that tha studenC types and to produce a line of inter-- 
na;F*^code^hat can be read by the procedures, in the XERS modu^la. 

4*1^ Rec u t g ^ ve C on t r o 1 ' ' - 

The parser uses a very conpon inethod called top-down parslrig with re-- 
ci^^sive descant to scan the input line and to produce an argunieTit line for 
XEI^S (th^ tnterprater) , The best way to explain this method Is with an 
exaf^ple. _^ Suppose the statement to ^W parsed is a LET scaterttent * v^^hich 
has \ha fot lowing sytita^: 

<\^aj'lable> f < ex press ion ^ » 

In this hm^:^ the parser first loolca for a legal BASIC ^eirtable . if ii 
finds on^^\ then it e^tamlnes the input string* expecting €in "^J- If it du^^ 
not find it, an error has obviously occurred* Otherwise^ the Sparser goes 
ahead and itfolcs for an expression, 

Thua^ the first action of the parser is to caj.1 the procedure 
varlableParSe. Iti the same way that ^ .lets (the procedure^^llad by 
.syntax, the paTseT control procedure^ to pars4 a LEt &ta((^pent) '*knows" 
the legal syntax ^ a LET statement i yar iabl^Parge "knDws"/what the 
correct syntax of a\varl^bl^ isiA ' j 

<vartiibie> *\<strlng varlatle> or ^numeric varicablG^ 

^aCrlflg va.€jUbrp ^ <strlng id- or ^btving id> (^ailth.feApO 

<nUriiofic vartoble^; - <nu!netlc id - or /-riumer Ic id? (^ar 1th , exp >) 
□ r ^^numerlc ld> (<arlth*e^p> ^ ^arith.exp>) 

Hencej it checKs the first part at ch^ line to see wheth^i the s^ariable 
is stria# or numeric. In either ca#o, tha parser then looks for a 
becaust/ the vaflable might be an arfay element. if no is found, con- 

trol rocurn^ to because the parser assumes the variable has been 

found* If £i "C" is found j however, yarlableParse passes control to aExp , 
the arithmetic Qxpresslon parser, iJpOn return from a Exp (in the case of 
a string V£irlable)i xrariableParae looks for the closing paranthG sis . If 
one la found, control la passed bac^ Co let a . If not, then a syntax error 
has occurred— either a parenthesis mismatch or an illegal aritfrnetic, ex-^ 
presalon, ' 

The procass continuos in this iriannGr. A Exp Liumod iat e iy passes con- 
trol to ^^Tarji w^hlch passes control to aFac tor , because of the syntax of 
arithmetic e^cpress ionsi * ' 

^arich»eKp> ^ <arith*term^ or <arith.term> ^ <arith.terni> 

<ar irU .cerm> ^ <arith, f accor>' or <aritU*factor^ ^ <^ar it f he cor ^ 

^/itich *f actor^^ ^ <arith,priiiiary> or <arlth,pr inuiry> " <ar ith.pr iinary 
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^FinaUy^ in aPrlma^ the parser looks for an arichinetic primary such as 
a num'ecic constant, a numeric variable ^ or a user-defined funcClonp If 
it finds a legal primary, it returns control back to aFacto r , Otherwise, 
a syntax error must haue occurred . , 



Eventually, control will be passed back up the line to lets (unless 
a syntax error .occurs) , ^which' will then look for the symbol , call th^ 

expression parser, ai\d return back to syntax. For example ^ the statemerit 



Z Oi 2) ^ INT (Y) would be parsed as tollowsi 



<LE T Stat tjment ? 



^ <variable> ^ , <BKpresBion>'^ ^ 

<nut7i var> ( aExp ) ^ aExp ^ 

Z (aTerm + aTerin) ^ aTertn 

Z (aFactor + aFactor) ^ aFactor 

Z (aPrtmary + aPrimary) ^ al-plJiiary 

Z ( X + 2 ) ■ " ^ INT ( aExp ) 

2, ( X + 2 ) ^ INT ( aTertn) 

( X + 2 ) ^ INT ( aFactor) 

( X + 2 ) ^ INT :(\Priraary) 

r V ( ^ + 2 ) ^ I It ^^-1 ) 

Thl^^ iuJ IcaL ea- exactly which procedures would be eralleW in the 
parsing of^^^^a^-^^tement - Each procedure calls the one beneath it In 
the hierarchy ^nd return a control baclc to the procedure which called It 
if it finds what it expects, (Thug^ the name "recursive descwt'* for this 
parse methods because the parser descends through levels of procedures 
until it finds a match for the part of the stateinent It is locking at,) 

4,2 Tj^pej and_ Tokenj 

However, the parBer musL know eKfctly how niuch of the line is to bu 
examined at any given time* To do this, it uses a procedure called getTok 
which takes the ncKt syntactically meaningful part of the input string and 
puts it in the variable token , At the same time, it "types" this token" 
that is, it assigns to It a numher that indicates what^^its meaning Is* 
These types are definod as macros In the file MACROS te*g,> intc^ la de= 
fined as 17) so that thpy can be u^ed In CUSR statements* The uae of mne- 
monic macra names instead of integera makes the coda more readable. The 
macro names for the types a re listed on the following p^ifi^. 
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numeflc variabiiiy 
St ring varlab Le / 
' St ring cons tant/ 
nutnerlc constant 
-^-^/&() J 

a user-def Inad function 

an — or _ 

< 
> 

boolean not 
bcolean and 
baolean or 
square root 
trsncatei tnteg:er 
random riLirabir 
length of a string 
illegal character 
one -dl metia ion ni/merlc array 
two-'dl me tisXo na 1/ numeric array 
|Crlng array 
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For examjla, if the input llaa ware Z (X + 2) - INT (Y), the procedure- 
g etToken ^ould pass the line Co the other procedures of the parser as follow 



nld Z, oper nld I, oper +, numcon 
inceqv INT, oper C, nld oper ), 



2 oper ) J eqal ^ , 



<Later, during the yar iable-par sing routine, the variable Z is rerDgnlEed 
as an array variable, so its type vould he changed to narray for the^ inter- 
preCer 4) * : 

^, ^x"^"!;' ^^"^ MtT£ten Is caired. It gets' a naw 'Waningf ul ayncac- 

tlc.A entice from the Input string, types this "entity," dncl places the 
vaiue^ Into the variables tokeii and t^. GecToken first gets the next 
nonblank, character on the string. Then, deF^^dlnron what the character u 
g eeroken aaslgns it a "preUtnlnary type" obtained directly from the array ' 
||||£|ble Cliil^lallaed In the module Pcom. which la listod in the file 
parse;, which has Rn entry for ^very ASCII character (e.g., typetabler+1 = 
oper, gypecahlefy] ^ nld, typetablaf I] - bad). cypetable l+J - 

usee this preliminary type to decide what no do next 
Fcr example, if the character is a letter. It scans the Input- line until 
a rionalphanumerlc charflCtGr la encountered, and'passea the resultinc 
serins to another procQdure typeld. which determines if the correct type 
Is a nutnerlc variable, string variable, user function etc If a " i- 
encountered, then jetTcken scans che line for another ".a^d aaaumea that 
whatever Uea becween the two Is a string constant. If the charncter i. 
a +•, /, , or nothing la done. 
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TUu purHor thvn usuh tlw information pawHed Co It by ge fTokcjn to decide 
wliat Lo do n€»xt , For example^ in the procedure aPriniary , if the current" 
Cj^£e [fi IntiTqVj the parser assumes (pGrhaps erroneously) that a value for 
tliu INT runutlon La f or tlicom ing , Ilencte, it calls tToken to be " (" after 
the caH, rlicn It callH get TQ|<en agnln, and then aEx£, because it assiimyH 
tiie arKiJiiiunt for tlie INT call.^.w.ill be an arithmetic eypTf^aion, Upon return 
from aEx£, it eKpects that t^icen will be if not, Hzmynta^ error has 

occurred . 

^ The main problem with this type of parsing algorithm occurs when it 
Is not Inmfedlately obvious what to do next even knowirig what the current 
token is. In BlP's parser, this situation occurs while trying to parse 
general expressions (in PRINT statements) and Boolean expressions. For 
example^ suppose we are attempting to parse an expression in a PRINT 
stateinent J and the currant token Is X* Although this eltmlnates a string 
expression frotn consideration, the parser does not know yet whether the 
eKpresslon is arithmetic or Boolfian;_ Jthe s^ta^ Orr . 

PRINT X^Y. Notnially parsys cry to solve this problem with a method called 
backufi, perhaps trying to" parse an arithmetic expression first. If this fails, 
the input gtring can be restored to Its original staCe, and a Boolean parse 
tried/ 

liIP*s parser usuh methods tliat try to duterinine the type of the exprt»HHlun 
wltiiout parBin^ It. For oKamplej to determine whether tlie expression is 
Booleanj the line is scanned ^ breaking on or "> " or "< "—which must be 

present in a Boulean expression.^ If one is found, the expression Is assumed 
to be Boolean; otherwise^ It must be arithmetic or string. In either case^ 
the line Is restored to its state before the scan, and the parse proceeds 
correccly. ^ 

the same type of problem can occur while paiBing a Boolean expressiun^ 
wliere clie parser expects to find a string or arithmetic expression followed 
by a Boolean symbol and then another arithmetic or string expression, if 
the token Ib a or a user--def ined function, the parser has no way uf 
telliny at that point whether the expression is string or arithmetic. Again, 
the input string is scanned for the type of expression it contalnB, 

4/3 Poi isli^Noiat ion 

III the procoBH of parHlriH the line, the parBer tranHfoitiiH it /from ItiltK 
(normal p/irontheFii?.inH) to pollnh notntlon, in which operators follow their 
argumentH^ For example, the uxpresBion 

INT (SQR CX ^ (2 + Y))) 

be come ^ 

K 2 Y + ^ SC^R INT 

in tlie poliBh notation* Also standard delimitors are used to signal chd 
beginnin^l of an array subHcrlpt and tfie end of an expression. For example. 
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A (3, Y + 2) becomes A (3, 2 Y +), 

[( used to denote beginning of an array or substring] 
ti used to separate aubscripts or string characters] 
t) used to denote the end of an array or suhstTing] 



For the sepa.ratlon of expressions in a PRINT statement, the ^onprintini 
character urhose character code Is 30 is us^ , For ^he separation of vari- 
ables in an INPUT, DIM, or READ, and the separation of data, a is used. 
As an eHample J 



IMPUT A, A?, B$ (J) becomes A; A$ ; B$ (J). 

The way the parser transforin^ the lir\e from infix to polish fiOLaLion 
is rather atraightf orward , In the '^IMT (SQR U * (2 + Y)))" examplB above 
while parsing the INT,'' instead of generating the code for the *'tNT** be- 
for6 agK£ Is dalled, the parser waits until after the return from aExp . 
Hence, the code for everything else has already been produced and the"''iNX* 
is tacked on the end. The same thing Is done whenever any operator is en- 
countered* 



Thua^^the code for "SQR" is tacked onto the end of K 2 Y + In the 

case of a binary operator (one that two argunients, such as + or ^) , 

basically the same thing is done. The code for the X is produced in aPrimary 
an4 then control passes .back to aTexm, Instead of making the code for the" 
^ at this stage, aTerm calls aPrlmary a second time, which then calls ASxp 
to parse the parenthesized^ expreBSlon. AExp calls aPrlmary which adde the 
code for the 2, but when control returns to a£xp , it does not generate the 
code for the but waits until after the aecond call to aPrimary (which 
adds the code for the Y) . Hence^ at this point the code is "X 2 Y . 
Finally, control passes back to aPrlniary , which finds the end of the par-- 
enthesized expression, and then to aTerm , which finally generates the code 
for the <What actually happena is probably less confusing than this 

descrlp tlon. ) 

* 

4.4 FormaC of the Cade Produced 



The code has a special fDrniat (accumulated In the ^Liing variable 
kode and then stored in an element of the argz array) so that it can bt 
easily scannea by XERS. An elemferrc^'^ of code has the format 

< ty|>e>< token><dGlimlter> 

and elements of code are atrung together to forrri the complete e^pressiou 
Each complete line of Internal code, corresponding to a BASIC expreHsion 
typed by the student, it atored in an element of the argz array, which 1« 
interpretted a line at a time, by the procedures in the XERS module. 

# 

Nonprinting characters whose ASCII codes are 1 through 23 are used 
for thq <type> and the nonprinting^ charafcter 29 la used for the <delimintor> 
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In Che above forniat specif leacion . Using lower-case letters (a - 1, b = 2, 
etc.r) to indicate the < type> and the ] character to indicate ^delimiter? 
tha internal code produced by the parser for the example discussed abov^ 
is: 



a X ] ^ 2 ] a Y ] e + i e ^ J p SQR ] q INT J . 

4,5 Arrays Affected by the Parser 

Finally, the parser updates five arrays (prgtxt , llnNumSy opers , 
argz , ancl order) each time a BASIC ^stacemenc is parsed, Prgcxt holds the 
exact text that was typedi linNuma , the Input line numbers; o£^srs , the 
BASIC operatora; and argz ^ the^code (as produced by the parBer) for the 
4-i«e^ -Every time a new (^yntac^leally cOTr^cC) line is typed by the stud^Cj 
the next element of each of those four arrays is assigned (in^ the procedure 
putLlnj apprpprlate values from the information in that line. The integer 
a/ray order tells the numerlcar (by line number) order of the lines. The 
value of fhe first element of order is the index into the other four array^j 
of the line with tha loweec line number; the value 'of the second element is 
the indax of the line with the next higher number, etc. 

For exampie^ if the student input the fQllowing lines aa a solution 
to the simple pmsk "SPOON*''' 



order typed 



10 REAJD X$ 

20 READ Y$ 
100 DATA ''SILVER*^ 

30 PRINX X$ 6 '' " 
999 END 



"SPOON' 
6 Y$ 



numerical order 

10 READ X$ 

20 READ Y$ 

30 PRINT X$ S ' 
100 DATA "SILVER"^ 
999 END 



a Y$ 

•'SPOON" 



Lhen the values of the g^lx r ^ 1^1 uNujras ^ o£££^* ^^^d oidcL i ay t? tssmeriL iHGi 



index 




prgTxt 


11 riNums 


Qpv t ^ 


u r d t 


1 


10 


READ Kl 




RKAD 


1 


2 


20 


READ Y$ 


/ 20 


READ 


2 


3 


LOO 


DATA " SILVER", '*SPOON" ' 


100 


DATA 




4 


30 


PRINT X$ 6. " " 6i Y$ 


30 


PRINT 


3 


5 


999 


END 


999 


END 


5 s 
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SECTION 5. XERS MODULE 



The workings of the interpreter are relactvely simple when compared 
with the parser. Because the argument code generated by the parser (and 
scored in the array argz) is in polish notation, it la simple' to use sCarks 
to evaluate expreasions. Again, an example i# appropriate . Suppose we ' 
wish to evaluate the polish expresaion i 

X 2 Y + * SQR INT. 

The heart. of XERS, the procedure gyalToken . is designed tu perform certain 
actions depending on what t^ the current token In the args string la 
(To get another token off the args a t ring the procedure nextx is called. 
.n^scms ta^hB i^t^ l AmXM^ new token and"7ypi in the 

vac ables of the same name.) In this example. evalToken would do the 
following as each t qkeji is acanned: _ " 



X 
2 
Y 
+ 



SQR 
INT 



Push the value of X onto the real stack. i 

Push 2 onto the real stack. 

Push the value of Y onto" the real stack. 

Pop the top two values off the real stack, add them. 

and push the result onto the real stack. 
Pop the top two values off the real stack, muiciply 

them and push the result, 
rop the top value off the real stack, take its square 

root, and push the result onto the stack. 
Pop the cop value off the real Stack, truncate it, and 

push the result back onto the real stack. 



Hence , 



INT (SQR (X * (2 + Y))) 



haa been evaluated 



iVny expression is evaluated Ln l «ajn« way. a .ii^n, .uu.,,ii . i.,.. 
occurs if we wish to evaluate the value of an array varlnble. In this 
case, we make use _oi a procedure called goUntll. which calls the token 
evaluator (evalToken) until a specified delimiter character is reached 
Fo.r oxaniple, auppoBe we wish to evaluate the value of 

A$ (X +2) & X$, in polish form: AS (X 2 +) X$ &. 

Upon gutting A$, since the incerpretpr realizes it is an array va. l.,l. u- 
IC doea not try to push its value onto the stack. Rather, it scans past ' 
the C symbol, and then calls goUntll to call the token evnluator until a 
) is reached. Hence, the following occurs: 



X 
2 
+• 
) 



Push the value of X onto the ronl stnck. 

Push 2 onto the real stnck. ' 

Pop the top values off, add tliem, push the result 

Stop. ^S. 
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f 

Al ihiH i)i)lii,L, Lliu valuu ul' K. 2 la Hlttiiig on top o£ Lhw H't«ik. So l\w 

Interprutur i)ops Ltn valuer off Cht^ real scack, pushes t!u* value i>( A$ 

(X + 2) onto the string st^ck^ then does the following: 

X$ Push the value of X$ onto the string stack. 

& Pop Che top two valuta off iiie^ string stack, 

concatenate thero^ ^nd push the result back oato 

the string stacks 

Assignments are made In a siinllar manner. One important tiling should 
be noted~ti\e interpreter aasumes that the value we wi&h to assign to the 
variable is the top elemei^t al the stack just before the sssignmant is to 
be made* 

Suppose I for example ^ thac want to make the foIJIoving assignment: 
B (J)^ + INT (Y.)' Which has the following pollsti lorm: 

B (J) Y INT + ^ 4 

In this case, the 1 n t c rpr^ te r ' B flrHt Instrucciou Is goUu 1 1 1 ( j ^ which 
causes the e valuator to bu sciOB^ed qntil a is reacheci^ At this point, 

the valuta of B (J) + INT (Y) y^iil be on top of the stack. Upon examining 
the A, the evaluator will po[^ th«o aXack, and store that value In the varl-- 
able A^ 
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SECTION 6, ERRDOK MODULE 

Whein ^4 student gives the RUN comniand ^to BIP, the ERRDOK moduLe check 
the studccit^s program for a number of possible structural errors. 



ERRDOK employs a^^o-pass algorithm. If, at any point, an error is 
ancounter^ia, an appropriate error raessage is given and the program is not 
eKecuted^ 

^ERHDOK initlaily makes sure that there exists a program to be run in 
the 'tirslt palace, and that the last lihe Is an 5ND statement. If so, it 
then chec^a the prograni line by line for further possible errors. 

There are a few key variables and record listy employed tfy ERKDOK 
in its flrit pass through tha lines of the program. ' " 

1^ iSlH^ is a BOOLEAN that is TRUE whenever a BEUINSUB hnn noi yet 
be.en foUoiW^ed by an ENDSUB. 

2* iHEMvel talis the number of FOR statenients that have not yet 
been follWiad by NEKTs. 

X£E3£ai ^ STRING array with the najnes of the FOR loop \ndex 
variables, 

^\ jJ5S£i£aE is the^ record class for a linked list of records, one 
for each function defined in the program. It has three fields: "name,'* 
for the futiCtlon's name; "index," telling the location of the function 
definition In the prograni; and a link to the next record. 

^' .WISifigl ^^^^ record class for a linked llaL ut r^curd^^, unt- 
for each aubroutlne in the program. It has four fields: '*BubStar t , 
. for the mem line number; ''subEnd," for the ENDSUB line uumber; a 
pOOLEArl "referenced," set only when ii GObUB references the subroutini±i 
and a link t.o the next record. 

_ fSSsisM ^he record cia^a for a linked list uf iecord«, oae 

for each PqR loop in the program. It has three fields: "forStart^' for 
tho FOR llnit^ number; "forEnd/* for the NEXT line number; and a link to tht^ 
next record-^ 

If thyi ilrie being checked in the first pass givey a tunctlun deflnl-^ 
tion, ERRpQiK checks the already existing userFng records (if any). If 
the "najiio" fletd of any of them le the same as the name of the function 
being deftay^, then the function has been defined twice, and an error 
message la .given. Otherwlae, a new userF iis record is created. 

An Em ita^tement that la not the last line of the program produces 
an "Illegnily located 'END^'' error message. 



If thii^ line being checked ia a FOR statement, the loopLcveJL numbtar 
is IncrcmetuCW and tho array clement f o r V a r [ 1 o o p L q y o 1 ] is set to the FOR 
loop's Indw Vflrlablo, a nw FORe laHB recorCwltF tho "forStart" field 
set to the CMrr^^nt line. Lb created, \ 
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When a NRXT atatement Is encountered, loopLeve 1 is checked. If it 
Ib zero, tlicn r:h.c? program has a '*-NRXT* witliout T. procf*fIing 'FOR'" error, 
OtherwUt', rurVjjy [ l oapLevel ] Is checkac]. If It 1b not iho Hnmc as thu 
V;irl'nhh' In t Ito NK>(T Wt n t cmhoii L ^ hn ''Illt^^ally nuHLed r OH , _ Nl'X^f loop" 
urror han fioen tlftofU^d. Otherwlst*, tho "forrind" flelfi of i lu« KORclasH 
record for the iogp Just endlag=is set to the NKXT statemcMU's I tpe num- 
ber and loQpLevei la decremented. 

If the line being checked is a BEGINSUB statemenc and the BOOLEAN 
variable InSub ii TMVE^ then an "Illegally imbedded subrout ine" ' error has 
bee^n found--a suhrcjXJtine has begun inside another aubroutinc. Otherwise^ 
InSub is set to tWt ^ and the previous non^^REM statement is checked. 
If It is not a STOP,^ a GOTO, or an EM)SUB statementi then there is an 
error: execution of the scudent's program conld Illegally fall through 
into the subroutln^a/ Otherwise a new SUBclass record, v^ith the "subStart'* 
field set to the current line number and the '*rcf erenced field initialized 
to FALSE, is created. 

When an ENDStlB statement 1h encountered, If InSub in not TKUK:, then 
the prograni has "■ENDSUB' without a preceding * BEGTNSUB-? error. Other-^ 
wise, the "subEnd*' field of the SUBclass record for the 

ending is set to th% EKDSUB statement's line number^ and inSub is set to 
FALSE. 



Other statainants are ignored during the firsL pa.-^a. 
> 

If the first pass is complete and the variable InSub is TRUE, then 
a ''Missing •EHDSUB'* after 'BEGINSUB*'' error has occurred/ And if loopLeval 
is not aero, then a '-'FOR' statement without matching 'hTEXT'" error has 
occurred , 

Ocherwise, ev^ry/thlng Is all right so fnr, and all GOHUH, cibro, and IF 
Statements are chi^^cke^d in tlie second pass. 

COSUB state4T^^ntB are checked to make sure that they branch only tu 
BEGINSUBs, And If the GOSUB Is located within the subroutine branched 
to, an error has occurred, since recursive subroutines are not allowed. 
(This error has occurred if the GOSUB 's line number is between the 
called subroutinaV^ he^ln^^ing and ending line numbers^-^its SUDclass 
record's "subStart"* and "subEnd" values.) If all is well, the ''ref erenced'* 
field of the siibroiUlne called by the (iOSUn Is set to TRUE. 

GOTf) and IF ^t*Uements are checked *to make sure that the lino to 
which they branch ^^D^ista 'and Is an executable statement (any statement 
other than a DATA or a DIM). Then an Illegal branch Into ttic middle of 
a FOR loop or intD oic nut of a subroutine Is checked f ui , 

Once the Bacamrpass is complete, the '-referenced" field of each 
SUBclass record la aheckedi If it is not TRUE, then an error has occurred, 
since all subrout Jnf.?M imist ^^t? referenced by at least one noSUB* 

Finally, If no atructural errors liave lu'en dntecLed by ERRnOK, ^^he 
progrnm is allpwi^d to run* 
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SECTION 7 . TEAGim MODULE 

- TEACH^'s main procGdureB handle task selection^' the post-taak Interview 
updating of the student hletory, and stepping the students through their' 
first session. ' ' ' \ 

In b^der tp Mnderatand how task selection is done, it is necessary to 
understand :thed&finition and usd; of ski lis and techniques , ,BtP»s cur-, 
i^iculum goals are the mastery of certain programming technlciues , including 
simple. output I using loops, conditional branches ^ and arrays; assignment 
to variablea^ etc. The techniques are linked In a linear order, each having 
but on6 'prerequisite" (thd previous technique) , based on dependence and in- 
creasing program complexity, v . ' % ./ \ 

The techniques are interpreted as sets of skills , which are ve^y spe^ 
ciflc curriculum elements like "prlntlrig a literal s^tring" or "using a 
counter variable in a loop." The skills are not themservea hierarchically 
\ordered. The appendix lists the techniques and fikills within them. The 
programming problems^or "tasks" are described in terms of the skills they 
use, and are selected on the basis of this description , relative to the 
studentU history of competence on each skill. Figure 2. shoi^^ a simplified 
portioh of the curriculiim network, and dtemonstrates the relationship among 
the tasks, skills, and techniques, * - 

' '' * * . ■ ' ■ ' ' ' \- 

The aigorlthra by which BIP selects a next task whan the student re- 
quests it la shown Ip figure 3. The selection process, begins with ^he 
lowest (least complex) technique. The procedure setUpSets puts all the 
skilly in that technique into a "set** (actually , a linked list of skill 
records) called my| which wlll^become the set of skills that the next 
fcask^ "may" use, 

- SetUpSets then examines the student 'a history bn each of the skills 
aasociated with the technique, to see if it needs further work. Two key 
counters in the history (see documentation for ONOFF) are associated with 
each skill. One is based on the results of the solution checker, and . ' 
monitors the student's continuing success in using the skill. The other 
is based on the student ' a :self-evaluatlon, and monitors his own continuing 
confidence in the skill. The. current definition of' a;, "needs work" skill 
l%one on which either counter is Eero, For^each successful use of a 
skill, both counters are incremated (in upVer) , If the student quits- 
a task requiring a particular skill, the^ first counter is decrementedi ^ 
if the student requests more work on a skill (during the post=task Interri 
view, dedcrlbed below), the second counter is zeroed, Any such "not yet 
mastered'V skills are put into thfe MUST "setf" (linked list of skill records). 
EvenCuallV the program will seek to. find a task that uses some of these 
MUST skills, ' \ ' \ ' 
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Figure 2* A simplified portion of the curriculum network. 
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Figure 3; Selecting the next task. 
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If no , MUST fikillu aro f0und (indicating thnt tha Htudont haa mnfiitfjrcd 
all the fiklllw at. thnt tGchniquo Invcl) , the fiearch proenns movc« up by 
ono tnclmique, nddinB all its skills to the HAY set , thcin^ soGking MUST - 
skiiie againi Oncu n MUST sot is generated , tho searcti tcrminatGs, and 
all of the tasks are dKamined by the procedure aelect, ./ Thoao con«ldorcd 
ati A posaffblG neKt task for the atudant muBt require (a) at loaBt one 
of the MUST skills, and (b) no skills . outside of the MAY set.- Finally, 
the task in this grouprthat requires the largGst numbGr of MUST |,kllls is 
presented as the next taek* Thus, in the simplified scheme shown In 
Figure, 2> asBumlng that the Student had not yet mat the criterion on the 
skills shown, the first task to be presented would be HORSE, becauBe its 
skill lies in tlje GarliGst tnchnique, and would constitute theifirst MUST ' 
sot* Task ASSIGN would be , presented ' next , since its skills come from the 
next higher tfechnlquei STRINGIN would be presqntdd last^ of these three. 

An in teres t ing , curriculum development technique iiaft evoJved naturally 
in This schem^V If BIF has BolGcted the MUST and MAY sets, hut cartnot 
find a taBk that meets the above i^equlrements , then it has found a "holn" 
in the currleulum, Aftpr writing a message to the HOLES file (see Section 
3,4 of Dageforde ^ Beard, Note 2) describing the nature of the missing task . 
(e.g., the MUST and MAY skills)| the procedure adjust examines the next 
/higher techniquer- It generates neW| expanded MUST and MAY setSj and then 
the procedure sielect again searches for an appropriate task? If none is 
'founds a new search begins baged on larger MUST and MAY sets. The only 
situatipn in which this process finally fails tb select a task occurs when 
the studteiit has coviered all of the curriculum. 

. ^ The first task a new student gets is not selected in this manner; 
it is automatically task GREENFLAG , whldtf requires a two-Xlne program 
solution. Bdcause this is expected to be thn student's first programming 
experience, and perhaps his first interaction of any kind with a computer ^ 
he is led through the solution to the task in very small steps, GREENFLAG 
Is the only task in the cu^rriculum that presents text ^from the file GREENF)^ 
asks questions, and expects the^ student to type "answers all of which^ 
alleviates the traamri of being told to write a program i!\ the first session. 
However, since the student'^ responses are frequently commands that are 
passed to BIP's Interpreter, he can see the effects of the Input, and emerge 
from GREENFLAG haying written and executed a genuine program* 

^ 'When a student has finished ^GREENFLAG or anyXother task by success- 
fully running his program, he proceeds by requesting '^ORE." The procedure 
moreo first looks through the student 's program for^'the MSIC operators 
and functions (If any) required in the sQlution to the task. If any re-^ 
quired element is missings he Is asked to add it to the program and rerun 
it before again requesting -toRE," If t;he program contains all the required 
operators and functions, the progedure verify is called' to evaluate it by 
comparing its output with that of the model solution run on the same test 
data (see Section 8)4 and the results are stored (in the student history) 
with each skill tequired by the task. Also, in , the post-task ^interview, 
the student is asked to indicate whether or not he needs more work on the 
skills required by the task, which are listed separately. Thus, as mentioned 
aboves BIP has two measures of the student*s progress in* each skill* its 
own comparisdn-test Results, and the student's seif-evaluation. 
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SECTION 8. VEUFY MODULE. ' 

- ^ ' ' ^ 

VERFY 4s the ^olutlon'-Ghecker module. ^Daslcally, it avaluateH the 
Btudent'B program by comparing its >output to that of the model solutions 
FirBt, the ptocedure verify calls vinit to InltiallzG variables, based on 
the coding Ifne that precedes the model 'solution in the TASKS file/ (See 
Section 5.2 of Dageforde S Beard, Note 2, for a detailed descrlptiqn of 
the coding line t) If that coding line does not start with a semicolonp 
^hen the student's program, is not checked; it is asigumed correct. Other- 
wise, the rieet of the line is scanned for option code characyfera and value 
llatsi If there Is^an "e," the yariable wantEKact is set td TRUE, since the 
"e" signifies that the student's program must produce the e^act sajne number 
of putput lines as that of the model*' An "n" signifies that numeric ex- . 
pressions are to be stored for comparison' (otherwiae they are Ignored), ad 
the variable wantNumCon is. set to TRUE. An -'r" signifies that there are 
random numbers used in the programs p and the "random" numbers t^ be plugged 
in during the solution checker's invisible (to the student ) execution of 
the tnpdel and of the studenp progrdm are stored' in the va^rlable savrnd. 
An **iy" s-ignifies that string eKpresslons are to be stored for comparison 
(ochferwlBe they are ignored) , so the varia^ble wantgtrCon is set to TRUE, 
A "v" signifies that all leading" spaces sh^ould be dlscarded before output 
is saved for comparison, so the variable vacuum is set to TRUE* 

NeKt, if there are any INPUT statements in the model (and thus presum- 
ably in the student program as well), havelnput is set to TRUE, *rhe first 
few lines of the. model solution are scanned, ainae for each INPUT statement, 
there must .be^ a RM at the beginning of/ the model solution describing the . 
u3e of t4ie input variable. The format of each of those REM statements is: 

<line 1h RM <variable name> ISl <descrip tion> , 

(For example- 10 REM X IS i THE USER'S FIRST ADDEND 

' *\ 20 Rm Y ISl THE USER'S SECOND ADDEND) "^^ " - -^ 

A linked list of inputVars records Is created, "one for each *INPUT variable 
expected. Each inputVars record has fb^r fieldsi "nme," for the varlabl^ 
name; ' "vals," for the value(s) to be aasigned to thm variable during execu- 
tion; "deacription," for the description of the variable; and "link," for 
the pointer to the next record. The "name" and "description" fields are 
assigned according to the information In the REM statements^ and the "vals" 
field ig assigned by the appropriate value /lists given at the end of the 
coding line. ^ - j 

After the initialization, the model solution is executed (invisibly) , 
and every line of output is stored (in the array printl ) for comparison, 
with the following eKceptioha. Any expression containing a quoted string 
or a numeric constant will not be stored^ unless wantStrCon or wantNumCon , 
respectively, is TRUE, If vacuum is TRUE, all leading spaces are deleted 
before a .line is stored. The integer variable outl tells the number of lines 
of model output stored, , 

If there is an execution error during the execution of the model, then 
the student ^is told so, and his program is assumed correct. Otherwise, the 
solution checker prepares to execute the student's program and compare Its 



. oiitpuL to that of the modelJ If there are any INPUT variableB (If havQlnput - 
la TRUE), then the iJrociQdurtt iclclputH Is called to find out what variable 
names the student uSed • KiAputB* gocis through the linked list of input Vara 
records and asks the student "What variable do you use for where the 

is replaced by the "dbscrlption" field of the record* The variable 
nolne typed In by the student is checked to make su^e that it is a valid 
variable name, that it is of the correct type (numeric or string), and 
that tlie student l|a«{not already said }]e used that variable name. If it 
is invalid for any reason, the student is told why^*and asH^d to retype th6 
variable, name. Whep a vallcJ namfe is typed, it is compared to the ''name" 
field or the record* If they are not the same, then the "name" field is . 
replaced by the student's variable^ name* . Opte again , as beforb eKecution ^ 
of the model solution, tlie "vals" field is set to the values to be assigned 
by INPUTS of this variable* I ^ ^' 

After finding out the student ' s input variable names, Ihe elements 
of a. Boolean array called matchup , which is parallel to the array prlntl , 
are initialized to FALSE. Then ^he student's program is eKecuted (Invisibly) 
and given the same "random" numbers and INPUT values (if any) as' the model 
solution* Each line of its output (wi^th the same vacuum , wantStrCon , and 
wantNumCon restrictiona as for the model solution) is stored in the array 
printk and compared to thfe stored output from the model ( printl) . If the 
line matches the ith element of prlntl , then matchup [i] is set to TRUE, 
The variable outk tells the number of lines of student output stored* If, 
after th^ student ' s ^program has completed ^execution, any of the elements 
in the mode i-out put* array . Xpginfel ) have not been matched (i.e. , if ma. t chup [ i ] 
- FALSE for any 1| i ^ 1, 2 ^S^, ^ * ^outJ ) , he is told that 'the program "does not 
seem to solve the problem, "^and the unmatched elements are Ilstfed, Or if 
want Exact is TRUE and outk Is greater than outl , the student is told that 
the program produced too much output* In eittier case, the procedure verQption 
is called. to determine whether or not the student wants to continue work on 
the task, and, if not, whether or not he disagrees with the solution checker, 
(If this is the case, this fact and the student's program are recorded in 
the file ARGUE), In addition to listing the putput not found , verOption 
t el Is "what values t^u re^ assigned t o - INPUl- v.i f iablcs , and which, types of __ _ ^ 
conBtants (numeric ancl/ur string), if any, the solution checker ignored . 
If, on the ottier hand, all the model outputs have been matched (arid gu^j^ 
^ Q^tl if wantExact is TRUE), the student is told that the program "looks 
ok," and the post-taak interview (see Section 7) is presented* 

"' ' • <r - ' I ' ' '■ • ' . 

I . ' ■ 
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SECTION 9. ; MHRljas MODULI^ ' 



I. 



The EQ are a nuinbei? of linked lists .of records built upland uaed through- 
out a BIP searfion. In particaiar,' there Is a llnkod list of records for every 
type of 'variable (numeric, string, 'pne-dlmanslonal numeric array, two-dimen- 
sional numeric .otray, onB-dlmenaional string array) used^ in the student'a 
qurront progi^am. Theresa also a linked llflt of recorda. for the user-defined 
functions, and the solution checker utilizes a list' of the expected ■ INPUT , 
varlablea, , ■ 

The first two fields of all these records are the aamor "name" for 
the variable (or function) name', and "llnkV for a pointer to the next record ' 
in the linked list. In addition, ,the numeric and atrine variable records 
have a "val" field holding the current valufe (numeric 6r string) of the 
variabl^e- the one-dinienBlonal array variable records (numeric and string) 
have an "upperBound" field for the upper bound of the atray (the lower 
bound of all DIP arrays is 1) and" an "array a" field for' the 'actual array. 
The two-dimensional numeric array records have the same fields as the one- 
dimensional ones plus a "secondUpperBnd" fifild for the upper bound of the 
second dimension of Che array. INPUT variable Records have a "vals" field 
for ^the values to be successively assigned to the INPUT variable by the 
solution checker. Finally,' uaer-f unction records have an "Index" field 
for the index into the argz array (see Section 4) of the line in the pro- 
gram containing the function definition. , , 

^ Further examples of the extensive use of linked lists of records ^ 
are: , • 

L 

1. T.ie data structure for ^the main tusks (as described in the documen- 
tation for ONpFF) is a linked list of records, each with 13 fields. 

2. The MUST and MAY "sets" of skills used in tasU-salectlon (see " 
Section 7) are actually separate linked lists of records, each with two 
fleldsi "akindex" for th^ fiklll number, and "link" for a pointer to ' 
the next Eecord-ln^tha— list, - _ _ „ ^ 

3. %ie MAYBE "set" of possible, next tasks to be presented*by the task- 
selection algorithm is, a linked list of records, each with three fields? 
I^task" for a pointer to the task (in the linked Hat of main task records), 
'numMustSkills" for the number of skills In the MUST set that the task ' ' 
uses, and "link" for a pointer to the next record. 

■ The MSRECS module contains procedures useful for handling records and' 
linked lists of -records. The "is" procedures (Isnal . Issa . etc.) check (at 
execution time) to aee if a given variable Is in the appropriate list (ej^f^ 
the one for one-dimensional numeric array variables, or the one for st^ng ' ' 
varlablea). The "create" procedures (nvCreate . nalCreate . etc.) creale a 
record of the ^eslred class and initialize various fields according to the 
information passed to the procedures. 

" Put InMaybe adds a- task to' the MAYBE "set" described above. RetnoveFromMaybe 
eliminates inappropriaCe tasks (those with skills outside the MAY "set") ^ 
from that ll'st.. , 
, ■• • -I 
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RaqCrcatci crenta^ a new Tccord to be added to the linked llHt of; 
opcratorB or functlono xequired in the solution to the curront taak* 
Hflcli^ record has two fields, "name" for the name of the operator or 
function that is requlrjed , and "link" for a link to tho next record 
in the list* Heqljcniove removee, a record from the ligt » iaUequired 
checks to see if a particular operator is, required (i^e,, in the linked 
list) and liBtUequirod simply steps through the list -and types out the 
"name" field of each of the records (see Section 2), 

SkCreate creates a new skill record and initializee its two fleldai 
"sklndexX for the skill number , and "link" for a pointer to the next 
skill rec^d in the list* AddtoList adds a new skill record to a linked 
list of sKills (note that they are In numeric- brdefj by skill number) , 
and empty tells whether or nbt a particular skills list is empty. As 
mentioned abovej the MUST and MAY "sets" used in task-selectiora are both 
linked lists^ of skills. * ^ 

Insert inserts a record at the beginning of a linked list. Inlist 
checks to see whether or not a particular string is the same as the "name" 
field of any of the records In a specific linked list. All of the "is" 
procedures call ihList with parameters telling which linked list (the one 
for numeric variables, or the one for string variables^ etc.). to check 
and what "name"^to search for* 
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LIST OF TECHNIQUES AND SKILLS IN TECHNIQUES 
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LIST OF TECHNIQUES AND SKILLB IN TEGIINIQUES 
Technique 1. Simple output— first proKratha ; ^ - . / 

1 Print numeric literal . \ 

2 Prirtt string literal \ / 
5 Print numeric eKpression [operation oil literals] ' 

8 Print string eKpression [ CQncatapation of llterais] 



Technique 2 , Varioblaa—aasignment , / ' 

3 Print value of numerljC variable 

4 Print value of string variable 

6 A Print numeric expreBSldn toparatlon on variables] 

7 Print numeric eKptession [operation on litarals and variables] 

9 Print string expression tconcatanatlon of variablea] 

10 Print string expression [ concatanation of variable and literal 

11 Assign value to a numeric variable [ literal value] 

12 Assign value to a string variable [literal value] 

Technique 3, More , compligated assignment . > 

34 Assign to a string ^variable [vdlue of an EKpression] 

35 Assign to a numeric variable [value of an eKpresslonl 

69 "--^ -. . . . r 

70 

82 
83 



Re--AssiBnmcnt of string variable (using its own value) 
ReTasaignment of numeric variable (using its own value) 
Assign to numeric variable the value of another variable 
Assign to string variable the value of another variable 



Technique 4, More complicated output , 

28 Multiple print [string literal, numeric variable] 

29 Multiple print [string literal, numeric variable expression] 

30 Multiple print [string literal, string variable] 

74 Multiple print [string literal, string variable ^expression] 

Technique 5. Inter&Qtive programh— INPUT from user— using DATA , 

13 Aaaign numeric variable by -INPUT- , 

14 Assign string variable by -INPUT- 

15 Assign numeric variable by -READ- and -DATA- 

16 Assign string variable by -^RE^- and -DATA- 

55 The Rm statement ^ - . ' 



Technique 6. More comp licated inpiif. 

17 Multiple values in -DATA- [all numeric] 

18 Multiple values in -DATA- [all string] 

.!& Multiple values in -DATA- [mixed numeric and string] 

22 Multiple assignment by -INPUT- [numeric variahles] 

23 Multiple assignment by -INPUT-f [^trlng variab^a]* 

24 Multiple assignment by -INPUT- [mixed "numerie l^sst^ing] 

25 Multiple assignment by -READ- [ninnerlcj ^^^^ 

26 Multiple assignment by -READ- [string] ' 

27 Multiple assignment by -RE^- [mixed nimeric and atringj 
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Technique 7, Branchln B^pro^lra m flow . . 

36 Unconditional branch (--GOTO-) . * 

37 IntDrrupt exedution , ^ 

Technique 8> Boolean eKpreaslonB^ ' 
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38 Print Boolean expresaion [relation of Btrlng llteralei 

39 Print Boolean exprdssion [relation of numeric llceralsj 
Print Boolea;i expression [relation of numeric literal and variable] 
Print Boolean expression [relation of string literal and variable] 

75 Boolean operator --AND- ^ 

76 Boolean operator -OR^ ^ 

77 Boolean operator *-NOT- 

Technique 9^ IF statemGntS"^condltional B tandardB, . t 

\ 42 Conditional branch [compare numeric variable with numeric literal] 

43 Conditional branch [compare numeric variable with eKpresalon] 

46 . Conditional branch [compare two numeric variables] 

47 Conditional branch [compare string variable with string literal] 

48 Conditional branch [compare two string varlabiesj 
59 The -STOP- statement i " . V 

Technique 10, , Hand-made loopg-^iteration p 

44 Conditional branch ^[ compare cpunter with numerld literal] 
45/ Conditional branch [compare counter with numeric variable] 

49 InitlallEe counter variable With a literal value 

50 Initialise counter vartable with' the value of a variable 

53 Increment the value of a counter variable 

54 decrement the value of a counter variable 

Technique 11^ Using loops to accuinulate i 

51 Accumulate succeSBive values into numeric variable 

52 Accumulate aucceaslve_.values into Btring^^var - 

71 Calculating complex expressions [numeric literal and variable] 

IS Initialize niunerlc variable (not counter) to literal value 

79 Initialize numeric variable (not counter) to value of a variable 

80 Initialize string variable to literal value 

81 Initialize string variable to the value of another variable 

Techniq ue 12. Using "dunmiy" value to signify end of data> . ^ 

20 Dummy value' In -DATA- statement [nimeric] 

21 Dummy value in --DATA-* statement [string] 

Technique 13. BA SIC functlondls, • 

^56' The -INT- function . 

57 The -ROT- function 

58 The -SqR- function 
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Technlq Ue 14 . FOR. , .NEXT loopg , ^ 

61 FOR , NEXT loops with literal as final value of index 

62 FOR , Nmi loops with variable aa final value of index 

63 FOR NMT loops with positive step size other than 1 
64. FOR . ^mt loops with negative step slge ' > 

Techniqu e 16 ^ Arrays , \ - 

31 Assign element of string array variable by -INPUT-- 

32 Aasign element of numerle array variable by -INHJT-- 

33 Assign element of numeric array variable [value Is also a variable] 
60 The -Dm- atatement ' . . . 

65 String array using numlric variable as Index 

66 Print value bf an element of a Btrlng array variable 

67 Numeric array using numeric variable as index 

68 Print value of, an element of a numeric array variable 

Techniq ue 16, Nes ting loops (one loop Inside another) . 

72 Nastlng loops ^ ^ ' / 

73 Subroutines (*GOSUB- and friends) 
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